사무ONE 처음 설치하기 — 그림으로 따라 하는 안내서

컴퓨터를 잘 모르셔도 됩니다. 설치는 AI 도우미(Codex 앱) 가 대신 합니다. 사람이 할 일은 ① zip 풀기 ② Codex 앱 설치 ③ AI가 열어 주는 주소에서 로그인 세 가지뿐입니다. 명령어를 치거나 긴 글자를 복사할 일은 없습니다.

먼저 알아 두세요. 사무ONE은 "설치 프로그램"을 돌려 컴퓨터에 깔리는 방식이 아닙니다. 데이터는 Supabase(데이터베이스 서비스), 앱 화면은 Vercel(웹 서버 서비스)이라는 인터넷 서비스에 올라가고, 직원들은 휴대폰·PC 브라우저로 그 주소에 접속해 씁니다. 이 PC는 "올리는 작업"을 한 번 하는 곳입니다. 직원은 아무 계정도 만들지 않습니다. 관리자가 만든 아이디·비밀번호로 접속만 하면 됩니다.

0. 어디에 설치되나요?

zip을 풀어 놓은 그 폴더가 곧 설치 폴더입니다. 권장 위치는 C:\samuone 입니다.

• Program Files, 레지스트리, 시작 메뉴에는 아무것도 들어가지 않습니다. 폴더를 지우면 이 PC에서는 깨끗이 사라집니다(인터넷에 올라간 앱과 데이터는 남습니다).
• 설치가 끝나면 폴더 안에 .env.local(연결 정보), .setup(로그인 정보), .vercel(배포 연결), 설치기록.txt, node_modules(부품, 약 500MB)가 생깁니다.
• 왜 C:\samuone 인가요? 폴더 이름에 한글이나 띄어쓰기가 있으면(예: 바탕 화면\사무 ONE) 일부 도구가 오류를 냅니다. 영문 짧은 경로가 가장 안전합니다.
• 나중에 업데이트할 때도 같은 폴더를 씁니다. 노트북을 바꾸면 이 폴더를 통째로 옮기면 됩니다(.env.local 포함).

1단계. zip 풀어서 C:\samuone 만들기 (3분)

1. 사무ONE 홈페이지(https://samuone.pages.dev/download)에서 받은 samuone-1.0.0.zip 을 다운로드 폴더에서 찾습니다.
2. 파일을 오른쪽 클릭 → "압축 풀기…" 를 누릅니다.
3. 풀 위치를 묻는 칸에 **C:\** 만 남기고(뒤에 붙은 samuone-1.0.0 은 지움) "압축 풀기" 를 누릅니다.
4. 파일 탐색기에서 C:\samuone 폴더가 생겼고, 그 안에 처음 설치하기.html, 체험모드 실행.cmd, docs, scripts 가 보이면 성공입니다.

zip 안에 이미 samuone 폴더가 들어 있어서 C:\ 에 풀면 C:\samuone 이 됩니다. 만약 C:\samuone-1.0.0\samuone 처럼 두 겹이 됐으면 안쪽 samuone 폴더를 C:\ 로 끌어다 놓으세요.

2단계. AI 도우미(Codex 앱) 설치 (5분)

설치를 대신 해 줄 AI 도우미입니다. ChatGPT 무료 계정으로도 됩니다.

1. https://openai.com/codex 를 열고 "Windows 버전 다운로드" 를 누릅니다. Microsoft Store가 열리면 설치를 누릅니다.
2. 설치된 Codex 앱을 열고 ChatGPT 계정으로 로그인합니다. (계정이 없으면 그 자리에서 무료로 만들 수 있습니다.)
3. "작업할 폴더(프로젝트)"를 고르라고 하면 C:\samuone 을 고릅니다.

클로드 코드(Claude Code)를 이미 쓰고 계시면 그것으로 해도 똑같이 됩니다. 폴더 안의 안내 파일을 두 도구 모두 읽습니다. Node.js(앱을 돌리는 엔진)가 필요하지만 AI 도우미가 확인하고 없으면 직접 설치합니다. 관리자 권한 확인 창이 뜨면 "예"만 눌러 주세요.

3단계. Codex 앱에서 "설치해줘" — 로그인 두 번이면 끝 (15분)

대화창에 설치해줘 라고 치면 AI 도우미가 안내서를 읽고 순서대로 진행합니다. 사람에게 오는 요청은 아래 세 가지뿐입니다.

3-1. Supabase 로그인 → 인증 코드 알려 주기

AI 도우미가 Supabase 로그인 주소를 보여 줍니다. 그 주소를 브라우저로 엽니다.

• 계정이 없으면 아래 Sign up 으로 바로 가입합니다(이메일, 또는 ChatGPT 계정으로). 이메일 확인 링크를 누른 뒤 다른 화면으로 갔으면 AI가 준 같은 주소를 다시 열면 됩니다. 새로 요청할 필요가 없습니다.
• 로그인하면 인증 코드가 나옵니다. 이 코드를 AI 도우미에게 그대로 알려 줍니다(예: "코드는 A1B2C3D4").
• 막 가입한 계정은 비어 있지만 괜찮습니다. 조직(organization)과 프로젝트는 설치기가 만듭니다.

이 코드로 AI 도우미가 회사 데이터베이스(프로젝트)를 서울 지역에 직접 만들고 연결 정보를 가져옵니다. Supabase 화면에서 무언가를 복사할 일은 없습니다.

3-2. Vercel 로그인 → Confirm 누르기

AI 도우미가 Vercel 확인 주소(vercel.com/oauth/device?user_code=XXXX-XXXX)를 보여 줍니다. 브라우저로 엽니다.

• 계정이 없으면 Sign Up 으로 바로 가입합니다. 요금제를 물으면 Hobby(무료)로 시작해도 되고, 회사 업무용이면 Pro 를 고릅니다(아래 요금제 안내). 가입이 끝나 다른 화면으로 갔으면 AI가 준 같은 주소를 다시 엽니다.
• 로그인하면 코드가 보입니다. AI 도우미가 알려 준 코드와 같은지 보고 Confirm 을 누릅니다. 그리고 AI 도우미에게 "눌렀어"라고 하면 됩니다.
• 주소는 10분쯤 유효합니다. 지났으면 AI 도우미가 새 주소를 줍니다.

요금제 안내(중요): 사무ONE은 무료(Hobby)에서도 모든 기능이 동작합니다. 하지만 Vercel 약관상 회사 업무용(상업적 사용)은 Pro 요금제 대상입니다. 그래서 Pro(관리자 1명분, 월 20달러 안팎)를 권장합니다. 어떤 요금제를 쓸지 고르는 것과, 요금제 때문에 멈췄을 때 결제·복구하는 것은 회사의 책임입니다. 결제는 나중에 앱 안 설정 → 요금제와 결제 화면의 버튼으로 바로 갈 수 있습니다.

이 PC에서만 써 보는 체험 모드라면 Vercel 로그인은 건너뜁니다. AI 도우미가 물을 때 "체험 모드"라고 답하세요. 체험 모드로만 써 보기

3-3. 앱 이름 정하기, 그리고 기다리기

사이드바와 로그인 화면에 보일 이름을 물으면 답합니다(예: 우리회사 그룹웨어). 그 다음은 기다리기만 하면 됩니다.

끝나면 접속 주소(https://….vercel.app)가 나옵니다. 이 주소를 직원들에게 알려 주게 됩니다.

중간에 멈추면 메시지 마지막 줄 "→ 할 일"을 따르고 다시 설치해줘 라고 하면 멈춘 곳부터 이어집니다. 처음부터 다시 하지 않습니다. 인증 코드는 몇 분만 유효합니다. 만료되면 AI 도우미가 새 주소를 다시 줍니다.

4단계. 첫 로그인과 비밀번호 바꾸기 (3분)

1. 접속 주소를 브라우저(크롬·엣지)로 엽니다.
2. 아이디 admin, 비밀번호 1234 로 로그인합니다.
3. "앱으로 설치하기" 창이 뜨면 PC에서는 다시 보지 않기를 눌러도 됩니다(휴대폰에서 설치합니다).

4. 바로 비밀번호 바꾸기 화면이 나옵니다. 지금 비밀번호 1234, 새 비밀번호는 8자 이상, 영문과 숫자를 섞어서 정합니다.

5. 대시보드가 열리면 설치 성공입니다.

로그인이 안 되면 "아이디 또는 비밀번호가 올바르지 않습니다"만 나옵니다. 5번 틀리면 10분 잠깁니다. 오른쪽 위 내 이름 → 모든 기기에서 로그아웃을 누르면 휴대폰·PC 로그인이 한 번에 끊깁니다(휴대폰을 잃어버렸을 때).

5단계. 직원 등록 (10분)

인사 → 직원 관리에서 직원을 등록합니다. 아이디·이름·부서·직급을 넣고 처음 비밀번호를 정해 주면, 그 직원은 첫 로그인 때 자기 비밀번호로 바꿉니다. 직원에게는 접속 주소와 아이디·처음 비밀번호만 알려 주면 됩니다.

6단계. 어드민 화면

어드민 메뉴에서 전 직원의 근태·오늘 업무·휴가·승인 대기를 한 화면에서 봅니다. 승인 대기 항목은 여기서 바로 승인·반려할 수 있습니다.

지금 보이는 "[데모]" 항목은 설명용 예시 데이터입니다. 실제 설치본에는 없습니다.

7단계. 설정 화면 세 가지

왼쪽 메뉴 맨 아래 설정(총괄책임자만 보임)에 탭 세 개가 있습니다.

외부 연동 — 필요한 것만 넣습니다

각 칸 아래 연결 테스트로 바로 확인됩니다. 하나도 안 넣어도 나머지 기능은 다 됩니다.

시스템 — 버전 확인과 기능 켜기/끄기

쓰지 않는 기능(예: 블로그)은 체크를 풀고 저장하면 메뉴에서 사라집니다. 데이터는 지워지지 않습니다. 저장한 뒤 AI 도우미에게 업데이트해줘 라고 해야 반영됩니다.

요금제와 결제 — 결제 화면으로 바로 가기

Vercel·Supabase 결제 화면을 여는 버튼과, 서비스가 멈췄을 때 복구하는 방법이 있습니다.

8단계. 휴대폰에서 쓰기 (5분)

1. 휴대폰 브라우저로 같은 접속 주소를 엽니다.
2. 홈 화면에 추가: 안드로이드(크롬)는 메뉴(⋮) → "홈 화면에 추가", 아이폰(사파리)은 공유(□↑) → "홈 화면에 추가". 앱 아이콘이 생깁니다.
3. 홈 화면 아이콘으로 열어 로그인 → "업무 알림을 받아보세요"에서 알림 켜기. (설정 → 외부 연동에 웹 푸시 키가 있어야 알림이 옵니다.)
4. 출퇴근 버튼은 휴대폰에서만 보입니다. 위치 권한을 허용하면 GPS로 출퇴근이 기록됩니다. 작업장 위치와 반경은 인사 → 작업장 관리에서 정합니다.

체험 모드로만 써 보기

Vercel 없이 이 PC에서만 돌려 보는 방법입니다. 3단계에서 AI 도우미가 Vercel 로그인을 안내할 때 "체험 모드" 라고 답하면 됩니다.

• 설치 뒤 폴더의 체험모드 실행.cmd 를 두 번 클릭하면 서버가 켜지고 브라우저가 열립니다(처음 한 번 2~4분).
• 주소는 http://localhost:3000. 같은 와이파이의 다른 기기는 http://<이 PC의 IP>:3000.
• 한계: PC를 끄면 아무도 못 들어오고, 휴대폰 앱 설치·푸시·GPS 출퇴근은 안 됩니다(https 주소가 아니라서). 자동 실행(자동 퇴근·연차 발생)도 설정 → 시스템에서 직접 눌러야 합니다.
• 정식으로 쓰려면 AI 도우미에게 "Vercel로 올려 줘"라고 하면 Vercel 로그인부터 이어서 하고, 데이터는 그대로 둔 채 인터넷에 올라갑니다.

잘 안 될 때

그래도 안 되면 폴더 안 설치기록.txt 를 판매처에 보내 주세요. 비밀값은 가려져 있어 보내도 됩니다.

업데이트는 어떻게 하나요?

새 버전이 나오면 관리자 화면 위에 "새 버전" 띠가 뜹니다.

1. 설정 → 시스템의 안내를 따라 새 samuone-x.y.z.zip 을 받습니다.
2. zip을 풀지 말고 사무ONE 을 설치한 폴더(처음 zip 을 풀었던 폴더, 권장대로 했다면 C:\samuone)에 그대로 넣습니다.
3. Codex 앱에서 업데이트해줘 라고 합니다. 바뀐 파일만 교체하고 다시 올립니다. 설정·연결 정보·직원 로그인은 그대로 유지됩니다.
4. 끝나면 받은 zip 은 자동으로 지워집니다. 따로 정리할 일은 없습니다.

더 자세한 내용

• AI 도우미가 읽는 상세 절차·모든 옵션: docs/설치안내.md
• 무료 요금제의 한계: docs/무료플랜-안내.md
• 지메일 연결: docs/gmail-연동.md